home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.5 Applications 1999 May / SGI IRIX 6.5 Applications 1999 May.iso / dist / arraysvcs.idb / usr / share / catman / a_man / cat1m / ascheck.z / ascheck
Text File  |  1998-10-27  |  6KB  |  133 lines
  1.  
  2.  
  3.  
  4. aaaasssscccchhhheeeecccckkkk((((1111))))                                                          aaaasssscccchhhheeeecccckkkk((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ascheck - validate the array services configuration
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      aaaasssscccchhhheeeecccckkkk [ ----FFFF ] [ ----KKKKllll _k_e_y ] [ ----KKKKrrrr _k_e_y ] [ ----pppp _p_o_r_t ] [ ----qqqq ]
  13.           [ ----ssss _s_e_r_v_e_r [ ----DDDD ] ] [ ----tttt _v_a_l_u_e ]
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _a_s_c_h_e_c_k validates the configuration on all the array services daemons
  17.      known to the local array services daemon.  Checks are made to ensure that
  18.      the various array and machine definitions are consistent with each other,
  19.      both on the individual servers and with corresponding definitions on the
  20.      other servers.  If any problems are found, they are described in detail
  21.      and suggestions are provided to correct the situation.
  22.  
  23.      It should be noted that _a_s_c_h_e_c_k is not a syntax checker for the
  24.      individual array services configuration files; that function is handled
  25.      by the ----cccc option of _a_r_r_a_y_d(1M).  Instead, _a_s_c_h_e_c_k is used to check the
  26.      semantics of a syntactically correct array services configuration file.
  27.  
  28.      _a_s_c_h_e_c_k relies on information provided by array services.  Thus, for
  29.      complete coverage, an array services daemon should be running on every
  30.      machine that is mentioned in the local configuration file(s).
  31.  
  32.      The checks that _a_s_c_h_e_c_k makes include:
  33.  
  34.      *  Ensuring that the local array services daemon is accessible.
  35.  
  36.      *  Verifying that all of the array services daemons known to the local
  37.         daemon are also available.
  38.  
  39.      *  Ensuring that each array services daemon is using the correct version
  40.         of the array services library.
  41.  
  42.      *  Ensuring that the LOCAL IDENT value used by a particular array
  43.         services daemon is not different from the "machine ID" used by the OS
  44.         on that daemon's machine.
  45.  
  46.      *  Suggesting that a "machine ID" be set in the OS on those systems that
  47.         have an array services daemon but have not yet set a machine ID.
  48.  
  49.      *  Ensuring that no two arrays on a particular server have the same ARRAY
  50.         IDENT value.
  51.  
  52.      *  Ensuring that the SERVER IDENT value which may be declared for a
  53.         particular ARRAY/MACHINE definition matches the LOCAL IDENT value of
  54.         the corresponding server.
  55.  
  56.      *  Warning if the list of machines defined for a particular array does
  57.         not match the list of machines for an array with the same name on a
  58.         different server.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. aaaasssscccchhhheeeecccckkkk((((1111))))                                                          aaaasssscccchhhheeeecccckkkk((((1111))))
  71.  
  72.  
  73.  
  74.      *  Warning about any server that has two or more arrays defined but has
  75.         not specified a default array.
  76.  
  77. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  78.      _a_s_c_h_e_c_k takes several options, primarily to control the selection of the
  79.      "local" server, and to select the desired amount of output.  The valid
  80.      options include:
  81.  
  82.      ----DDDD          When used with ----ssss, indicates that array services requests
  83.                  should sent directly to the specified server, rather than
  84.                  being forwarded to that server by the array services daemon
  85.                  running on the current machine.  This is the default
  86.                  behavior.
  87.  
  88.      ----FFFF          When used with ----ssss, indicates that array services requests
  89.                  should be forwarded to the specified server via the server on
  90.                  the current machine rather than sent directly.
  91.  
  92.      ----KKKKllll _k_e_y     Use _k_e_y for the local authentication key when communicating
  93.                  directly with a remote array services daemon.
  94.  
  95.      ----KKKKrrrr _k_e_y     Use _k_e_y for the remote authentication key when communicating
  96.                  directly with a remote array services daemon.
  97.  
  98.      ----pppp _p_o_r_t     Specifies the port address of the "local" _a_r_r_a_y_d server.
  99.                  Defaults to the value of the AAAARRRRRRRRAAAAYYYYDDDD____PPPPOOOORRRRTTTT environment variable
  100.                  if present, or 5434 otherwise.
  101.  
  102.      ----qqqq          Produce less verbose ("quieter") output.  Repeated
  103.                  occurrences (either ----qqqq ----qqqq ............ or ----qqqqqqqq ............)  may decrease the
  104.                  verbosity further.
  105.  
  106.      ----ssss _s_e_r_v_e_r   Specifies the hostname or IP address of the "local" _a_r_r_a_y_d
  107.                  server.  Defaults to the value of the AAAARRRRRRRRAAAAYYYYDDDD environment
  108.                  variable if present, or "localhost" otherwise.
  109.  
  110.      ----tttt _v_a_l_u_e    Specifies the timeout value (in seconds) used for waiting on
  111.                  individual responses from the array daemon.
  112.  
  113. NNNNOOOOTTTTEEEESSSS
  114.      The array services daemon (_a_r_r_a_y_d(1M)) must be running on all machines
  115.      that are to be examined.  It does not necessarily have to be running on
  116.      the machine that executes _a_s_c_h_e_c_k if an alternate server was specified in
  117.      some way.
  118.  
  119. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  120.      arrayd(1M), arrayd.conf(4).
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.